Semantic Versioning

Definition / 释义

语义化版本控制：一种给软件发布版本编号的规则，通过版本号的结构来表达“变化的性质与兼容性”。最常见格式为 MAJOR.MINOR.PATCH（主版本号.次版本号.修订号）：

• MAJOR：做了不兼容的变更（可能破坏旧接口）
• MINOR：向后兼容地新增功能
• PATCH：向后兼容的问题修复
  （有时还会包含预发布与构建信息，如 1.2.0-alpha.1+build.45。）

Pronunciation / 发音（IPA）

/sɪˈmæntɪk ˈvɝːʒənɪŋ/

Examples / 例句

We follow semantic versioning for our app.
我们对应用采用语义化版本控制。

If the next release removes the old API, semantic versioning suggests bumping the major version to signal a breaking change to downstream users.
如果下个版本移除了旧的 API，语义化版本控制建议提升主版本号，以向下游用户明确提示这是一次不兼容变更。

Etymology / 词源

semantic 意为“语义的、含义层面的”，versioning 来自 version（版本）+ -ing（表示过程/做法）。合在一起强调：版本号不仅是数字序列，而是“带有明确含义的编号”，用来传递兼容性与变更类型。该术语在软件工程与开源生态中广泛流行，常简称为 SemVer。

Related Words / 相关词

• Semver
• Version
• Release
• Changelog
• Backward Compatibility
• Breaking Change
• Deprecation
• Patch
• Minor
• Major

Notable Works / 文献与作品中的用例

• Semantic Versioning 2.0.0（Tom Preston-Werner，语义化版本官方规范文本）
• Pro Git（Scott Chacon & Ben Straub，常在版本发布与标签实践语境中提及语义化版本）
• *Release It!*（Michael T. Nygard，讨论发布与变更管理时常引用版本策略）
• The DevOps Handbook（Gene Kim 等，涉及发布流程与版本管理实践时常出现相关概念）